home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / comm / tie30.zip / README.TXT < prev    next >
Text File  |  1996-09-11  |  16KB  |  317 lines

  1.                    Installation and Startup Guide for 
  2.                      Teamwork Information Exchange 3
  3.                                    
  4. This guide contains a instructions for installing and running Teamwork
  5. Information Exchange.
  6.  
  7. System Requirements & Configuration
  8.  
  9.      TIE  may  be run on any IBM compatible PC using DOS 3.3 or  above
  10.      and  is compatible with all network software that adheres to  the
  11.      file  sharing  protocols of DOS 3.3 and above.   TIE  requires  a
  12.      minimum of 400K of available conventional memory.
  13.      
  14.      Configuration Requirement: A minimum of 31 file handles  must  be
  15.      available  to run TIE.  The following line should appear  in  the
  16.      CONFIG.SYS file of all workstations running TIE.
  17.      
  18.           FILES=31
  19.      
  20.      Values  above 31 may be substituted if other applications require
  21.      more  file  handles.   Values above 31 may be  required  if  your
  22.      workstation  is  running memory resident  (TSR)  applications  or
  23.      utilities such as shell programs.
  24.      
  25. Installing TIE On Your Network
  26.  
  27.      For  multi-user access, TIE's data files must be installed  on  a
  28.      network server or workstation where the data files can be shared.
  29.      To  install TIE on the network server place the distribution disk
  30.      in drive A: and type the following command:
  31.      
  32.            A:INSTALL
  33.      
  34.      You will be prompted as follows:
  35.      
  36.      Disk drive where you want to install:  c     Enter    the   drive
  37.                                                   letter    for    the
  38.                                                   network server drive
  39.                                                   where  you  want  to
  40.                                                   install  the program
  41.                                                   and data files.
  42.      Suggested installation directory on drive X is  \TIE3   where "X"
  43.                                                   is  the drive letter
  44.                                                   specified above.
  45.      Press <Enter> key to accept or type a new path:    press enter to
  46.                                                   accept  the  default
  47.                                                   directory or enter a
  48.                                                   new directory name.
  49.      
  50.      TIE's  program and data files will be decompressed and  installed
  51.      on the designated drive and directory.
  52.      
  53.      The  main program (TIE.EXE) may also be installed on and run from
  54.      individual  workstations.   Note that not  all  networks  support
  55.      running  workstation resident copies of TIE with  access  to  the
  56.      data files on the server.  We recommend that, were possible,  the
  57.      program  be  installed on each work station.  This  configuration
  58.      reduces network traffic and improves performance.  To install the
  59.      TIE main program on a network workstation, create a directory  on
  60.      the workstation's hard disk and simply copy the main program file
  61.      (TIE.EXE) from the network server to the new subdirectory on  the
  62.      workstation's hard disk.  Example:
  63.      
  64.      C:                       Change to the workstations hard drive
  65.      MD \TIE3                 Create a subdirectory named TIE3
  66.      CD \TIE3                 Select the new subdirectory
  67.      COPY G:\TIE3\TIE.EXE     Copy  TIE.EXE  from the  network  server
  68.                               drive  to the workstation drive.   Where
  69.                               "G:"  is the network server drive letter
  70.                               where TIE was installed.
  71.      
  72. Starting TIE
  73.  
  74.      TIE  can  be run from any DOS workstation on the network provided
  75.      that  the  workstation views the server drive as a  standard  DOS
  76.      disk  drive.   In  many  installations,  access  to  the  network
  77.      server's  disk drive requires a local logon procedure before  the
  78.      server  volume  is  visible  to the workstation.   The  following
  79.      assumes that you have already gained access to the network server
  80.      via  your local log on procedure.  Your network manager may  have
  81.      provided  you  with  a batch file that eliminates  the  need  for
  82.      typing the individual commands.
  83.      
  84.      TIE  uses  DOS environment settings to determine the location  of
  85.      the  server resident shared data files and the default  directory
  86.      where  files  attached  to  mail messages  will  be  saved.   DOS
  87.      environment  variables are normally setup  in  the  workstation's
  88.      autoexec.bat  file.   The  required  environment  variables   are
  89.      specified as follows:
  90.      
  91.      SET TIEDAT=g:\tie3       Where  "g"  is the network drive  letter
  92.                               where TIE's program and data files  have
  93.                               been  installed.  If not specified,  the
  94.                               default   is  the  current   drive   and
  95.                               directory.
  96.      SET TIEINBOX=c:\inbox    Where   "c:\inbox"  is  the  workstation
  97.                               drive and directory where the user  will
  98.                               normally save email attachments.  If the
  99.                               common  use of file attachments in  your
  100.                               organization   is   for   sending   word
  101.                               processing  documents, you may  wish  to
  102.                               set   this   to  your  word  processor's
  103.                               default  document  directory.   If   not
  104.                               specified, the default is "c:\"
  105.   
  106.      To  run  the  server  copy of the program, when  TIE.EXE  is  not
  107.      resident  on  the  workstation's hard disk,  type  the  following
  108.      commands:
  109.      
  110.      g:             Where  "g"  is  the network drive letter  where
  111.                     TIE's   program  and  data  files   have   been
  112.                     installed.
  113.      CD \TIE3       Set  the  default  directory to  the  directory
  114.                     where  TIE's program and data files  have  been
  115.                     installed.
  116.      TIE            Run TIE.
  117.      
  118.      To run a workstation installed copy of the program with access to
  119.      the  shared  data files located on the network server,  type  the
  120.      following commands:
  121.      
  122.      d:\tie3\tie    Where "d" is the workstation drive letter where
  123.                TIE.EXE  has  been  installed.  TIE  will  look  for
  124.                shared   data  files  on  the  drive  and  directory
  125.                specified by the "TIEDAT" environment variable.
  126.      
  127.      Your  system manager will assign each authorized user,  a  unique
  128.      User ID which must be entered each time you start TIE.
  129.      
  130.      Command  line  parameters  are  available  for  adjusting   mouse
  131.      operation and improving network performance.  See Appendix A  for
  132.      details on command line parameters.
  133.      
  134. Establishing a System Operator
  135.  
  136.      TIE  is distributed with all data files empty.  Because there are
  137.      no  defined users in the system when TIE is first run, the log on
  138.      screen  is  temporarily bypassed and replaced  by  a  data  entry
  139.      screen  which allows definition of an initial user.  By  default,
  140.      this  initial  user  must be given the maximum (System  Operator)
  141.      privileges  in order that additional users can be  added  to  the
  142.      system.  When TIE initially starts for the first time, enter  the
  143.      information  requested  for  all fields.   Be  certain  that  you
  144.      memorize or write down your User ID before saving the entries.
  145.      
  146.      Immediately after saving data on the user definition screen,  the
  147.      logon screen will be displayed.  After entering your User ID, you
  148.      will have full access to all program functions.
  149.  
  150.  
  151.                  Appendix A - Command Line Parameters
  152.                                    
  153.      When  starting TIE from a command prompt, the  command  line
  154.      allows  for  specification of the location  of  shared  data
  155.      files,  optional mouse configuration parameters and optional
  156.      environment  parameters.  The order  of  parameters  in  the
  157.      command line is as follows:
  158.      
  159.           TIE [mouse parameters] [environment parameters]
  160.      
  161.      The  brackets  are not typed and are shown to indicate  that
  162.      each parameter set is optional.  Whenever the data drive and
  163.      directory  is  specified, it must be the first parameter  on
  164.      the command line.
  165.      
  166. Mouse Parameters
  167.      In  most  instances it should not be necessary to enter  any
  168.      mouse  parameters  on the command line.  On  EGA  or  better
  169.      monitors  the  mouse  is displayed as a true  mouse  (arrow)
  170.      cursor.  On other displays the mouse cursor is displayed  as
  171.      a block cursor.
  172.      
  173.      The mouse parameters that can be entered on the command line
  174.      are as follows:
  175.      
  176.      /nv  Disable  video bit manipulations.  You may  want  to
  177.           try  this  parameter just to see  if  you  like  the
  178.           screen appearance better.
  179.      /ng  Disable  graphic mouse cursor.  If the mouse  cursor
  180.           does  not  behave  properly when running  in  a  DOS
  181.           window  under Windows 3.x you may need to  use  this
  182.           parameter.
  183.      
  184.      If  both parameters are used on the command line, a space is
  185.      required between them.  Example:  TIE /nv /ng
  186.      
  187.      Special Note:  If your monitor goes blank when starting  TIE
  188.      or  becomes distorted, using both the /nv and /ng parameters
  189.      should  correct the problem.  In addition, these  parameters
  190.      are  required when running the DOS version of  TIE  in  less
  191.      than full screen mode under Windows.
  192.      
  193. Environment Parameters
  194.  
  195.      Several  environment parameters can be passed to TIE  either
  196.      on  the  command line or through the SET CLIPPER environment
  197.      variable.  The environment settings are as follows:
  198.      
  199.      E:<nExpandedKB>  The E option enables use of  LIM  4.0  -
  200.           compatible EMS memory and can improve performance on
  201.           workstations that have EMS memory.  If  your  system
  202.           is  running  EMM386, or another memory manager,  you
  203.           can  simulate EMS memory with the following  command
  204.           in your config.sys file.
  205.      
  206.                Device=C:\DOS\EMM386.EXE AUTO RAM
  207.      
  208.           To  use up to 512k of expanded memory, add "//e:512"
  209.           to the command line.
  210.      BADCACHE   Some caches that use expanded (LIM) memory  do
  211.           not  expect  that other applications will  be  using
  212.           expanded  memory and can burst into memory  segments
  213.           that  TIE is using.  The BADCACHE option provides  a
  214.           way around this.
  215.      SWAPPATH  <d:\directory>  The virtual  memory  management
  216.           system used by TIE loads as much of the program into
  217.           memory  as will fit.  When additional code  segments
  218.           are  needed,  the system swaps unneeded segments  to
  219.           expanded  memory  and loads the required  code.   If
  220.           expanded  memory  is unavailable or  exhausted,  the
  221.           code segments are swapped to the default disk.   The
  222.           SWAPPATH  option  allows  these  swap  files  to  be
  223.           redirected  to  an alternative drive and  directory.
  224.           To   reduce  network  traffic  and  improve  program
  225.           performance,  the  location  where  swap  files  are
  226.           written should be the local workstation's hard disk.
  227.           If  TIE is installed on the workstation, this is the
  228.           default.   Otherwise the SWAPPATH option  should  be
  229.           used.
  230.      TEMPPATH <d:\directory>  Sorting and indexing routines in
  231.           TIE  use  temporary scratch files to buffer data  as
  232.           they  proceed.  If the drive where the  TIE  resides
  233.           does not have enough disk space or is read only,  an
  234.           alternate drive and directory can be specified.
  235.      
  236.      Any one or more of these parameters may be passed to TIE  on
  237.      the  command line by entering two slashes before  the  first
  238.      parameter  and separating each parameter with  a  semicolon.
  239.      Example:
  240.      
  241.           TIE //E:512;SWAPPATH C:\TIE;TEMPPATH C:\TIE
  242.      
  243.      Alternatively,  these parameters may be declared  at  system
  244.      startup  and  passed  to TIE from the "CLIPPER"  environment
  245.      variable.  Example:
  246.      
  247.           SET CLIPPER=E:512;SWAPPATH C:\TIE;TEMPPATH C:\TIE
  248.      
  249.      When  placed  in your autoexec.bat file, this line  has  the
  250.      same  effect  as  passing  the E,  SWAPPPATH,  and  TEMPPATH
  251.      options on TIE's command line.
  252.      
  253.                             
  254.                             Troubleshooting
  255.                                    
  256. Out of Memory
  257.  
  258.      If  you  receive an Out of Memory message when running  this
  259.      program  it  means  that  you  either  do  not  have  enough
  260.      conventional memory available to run the program or there is
  261.      a fault in expanded memory.
  262.      
  263.      The  amount of memory available for running applications can
  264.      also  be increased removing unnecessary TSR programs (screen
  265.      savers,  DOS shells, pop-ups, mouse drivers, etc.)   If  you
  266.      are using DOS version 5.0 or higher, you may be able to load
  267.      some of these programs into high memory.
  268.      
  269. Runtime Errors
  270.  
  271.      The  most  serious type of potential problem is  a  run-time
  272.      error.   If this occurs, it will cause the program to abort.
  273.      When  this happens, the program will list several  lines  of
  274.      text which indicate the cause of the error and it's location
  275.      in the program's source code.
  276.      
  277.      If  you  get  a  run-time error, make a note  of  the  error
  278.      message.   Run-time errors can be the result  of  errors  in
  279.      data  entry,  improper system configuration, or  failure  to
  280.      have  your  printer on-line and ready when print  operations
  281.      are  being  performed.   Check your data  using  the  browse
  282.      functions  to  be sure that you have entered  it  correctly.
  283.      Run the Reindex option from the file menu to insure that all
  284.      files are properly indexed.  Also, check that your system is
  285.      properly  configured  ("FILES=31" in your  CONFIG.SYS  file,
  286.      printer turned on and on-line when printing reports).
  287.      
  288. Sharing Violation
  289.  
  290.      On  some networks a sharing violation can occur when two  or
  291.      more  users  attempt to execute a portion of  TIE  the  same
  292.      time.   To  solve  this problem, set the file  attribute  of
  293.      TIE.EXE  to  read  only.  This can be  done  using  the  DOS
  294.      attribute command as follows:
  295.      
  296.           ATTRIB +R drive:\TIE\TIE.EXE
  297.      
  298.      It should never be necessary to change the file attribute on
  299.      a workstation installed program.
  300.      
  301. Getting Help
  302.  
  303.      If  you are unable to resolve a problem on your own, send us
  304.      a  letter with the exact text of the error message (if  any)
  305.      and  a  compete  description of the problem,  your  computer
  306.      system (computer, memory, graphics card, DOS version, etc.),
  307.      the option you were running when the error occurred, and any
  308.      supplemental  data  which  you  entered  under  the  option.
  309.      Sample printouts are often key to uncovering the source of a
  310.      problem.   We  will investigate the problem and  respond  as
  311.      quickly as possible.
  312.      
  313.      If  it's  a simple problem or you just have a question,  you
  314.      may want to call us at (301) 306-0409.  You may also contact
  315.      us  by  Email  on Compuserve at: 72144,1223 or Internet  at:
  316.      72144.1223@compuserve.com.
  317.